package com.ruoyi.system.service;

import com.alipay.api.AlipayApiException;
import java.math.BigDecimal;

/**
 * 支付宝支付Service接口（若依框架规范：放在system/service目录）
 */
public interface IAliPayService {

    /**
     * 生成支付宝支付参数（APP/小程序支付）
     * @param orderNo 商户订单号（唯一，来自前端）
     * @param totalAmount 支付金额（元，保留两位小数，来自前端）
     * @param subject 商品名称（必填，来自前端）
     * @param body 商品描述（可选，来自前端）
     * @return 支付宝支付参数字符串（格式：app_id=xxx&biz_content=xxx&sign=xxx...，前端直接使用）
     * @throws AlipayApiException 支付宝API调用异常
     * @throws IllegalArgumentException 参数校验异常
     */
    String generateAlipayPayParams(String orderNo, BigDecimal totalAmount, String subject, String body)
            throws AlipayApiException, IllegalArgumentException;
}